This article describes how to write PIC 16C84 assem- 
bler code programs using a compiler written for the 
Windows 95/98 platform. 

The PIC compiler allows programs to be written in a 
high-level language and it generates the necessary 
assembler code. Ihe code can be modified, assem- 
bled orsimulated using the (free) Microchip MPLAB 


software. 


Ey Roger Thomas 


compiler for PIC16C84 


with code optimisation 


Compiler main features 


for PIC16C84 


b Extensive manual (56 pages) on disk 


b Three worked out examples on disk 


b Syntax similar to Visual BASIC and Pascal 


b Windows 95/98 compatible, no DLLs required 


b Generates assembler code for Microchip MPLAB (freeware) 


b Variables: 

b Arithmetic Operations: 
b Numeric Formats: 

b Boolean Functions: 

b Boolean Operators: 

b Compiler Commands: 


Boolean, byte, word 

оо о ОО 

decimal, hexadecimal, binary, char 
B ccc cL 

AND, OR, XOR 


Iif...then... else, select/case, while...loop, table, read, 


write/read, EEPROM, procedure, directive, ASM directive, input, output, alias, 


pin-name, RTTC, prescaler, wait, picfuse, 


b Equation Handler 
b Code Optimiser 
b Error messages 
b Interrupt handling 


There are considerable advantages in 
using a compiler. The ability to write a 
PIC program using English like com- 
mands is easier than programming 
directly in assembler language. Time 
ta ken to write and test software is usu- 
ally much less with a compiled lan- 
guage, and to prove the point the Win- 
dows PIC compiler itself was written 
using a compiler. 

The PIC compiler is not based on any 
one high-level language but has ele- 
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ments of Pascal and Visual BASIC. 
Furthermore the compiler is flexible and 
allows for different program syntax. The 
compiler is written for the Windows envi- 
ronment, which should make the soft- 
ware easy to use. As all the necessary 
PIC codes are defined within the com- 
piler program, no extemal setup or 
headerfiles are needed. 

The compiler produces assembler 
code directly from the high-level 
source program, so that the program- 


mer need not worry about the intrica- 
cies of assembler code programming. 
It can be educational for those leam- 
ing to program in assembler to see how 
easily understood high-level com- 
mands are translated into the equiva- 
lent PIC assembler code. 

Assembler code output files pro- 
duced by the compiler contain both 
the onginal high-level program (com- 
mented out) and the PIC assembler 
code ready to be assembled (or simu- 
lated) by the Microchip MPLAB software 
version 4.12 or later Having both the 
source and assembler code helps in 
debugging the program. Writing in 
compiled language does not preclude 
modifying oradding assembler code 
to the program when using the MPLAB 
software. MPLAB software is freely avail- 
able from Microchip’s web site at 
http ://www.microchip.com. 

The cost (in programming terms) of 
using compiled code can be reduced 
speed of execution as the machine 
code program may not be as efficient 
asa program written directly in assem- 
bler. 

With this PIC compiler this is not the 
case, in most circumstances the 
assembler code produced is the fastest 
code possible. There is very little com- 
piler overhead on the assembler code 
in terms of needing extra variablesor 
increased number of assembler instruc- 
tions. The only additional program 
code required is support for the 
Boolean and arithmetic commands. 
Arithmetic is either 8 bit (unsigned) or 16 
bit (unsigned). The compiler requires 
several bytes for storing arithmetic 
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results, these are labelled _5ТАСКххїп 
the output assembler file. 

The compiler makes two passes of the 
source program. The first pass creates 
а list of procedure declarations as ће 
compiler may come across a call to a 
procedure before finding the proce- 
dure declaration. On the second pass 
the procedure calls are reconciled with 
the procedure declarations. 

Compiler syntax is not case sensitive 
but the MPLAB software can be, this 
option is selected in the project hex file. 
Forthis reason all the procedure names 
and variables appearin uppercase in 
the assembler output file. 

To allow the compilerto be used for 
any similar PIC microcontroller the com- 
piler does not impose any code restric- 
tions. This is left to the MPLAB assembler 
which will check program size and can 
more easily produce memory usage 
maps and cross-reference files. 


Using the compiler 


Use a text editor (such as Notepad, 
WordPad orthe MPLAB editor) to create 
the high-level source program and 
sa ve the text file with a .psf file exten- 
sion (PIC Source File). Ensure that the 
sa ved file is text only and does not con- 
tain any embedded text formatting 
information. 

Unlike an assembler program that 
requires a strict code column order 
(labels, mnemonics, operands, com- 
ments), a high-level program freely 
uses spaces to indent the program. 
These spaces have no relevance to the 
program execution and are ignored by 
the compiler. Using spaces should 
make the reading and de-bugging the 
program easier. 


User interface 


The Windows PIC compiler is very easy 
to use, apart from using load and save 
file the compiler does everything else! 

As shown in Figure 1, the taskbarhas 
a number of icons. 


load - press the load button and a 
directory dialog box will appear listing 
all the source (filena mes.psf) files in the 
directory, select and load the relevant 
source file. The compiler will default to 
the directory that was last used. When 
the compiler is run for the first time the 
directory will be where the compiler 
program is located. 


save  -aftera successful compila- 
tion save the assembler source file 
(same file name but with filena me.asm 
file extension) by pressing this button. 
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Figure 1. The Compiler window. Note that PIC pin functions can be seen at a glance. 


This file will be saved in the same direc- 
tory as the source file. This assembler 
output file will contain all the additional 
PIC code required asthe compiler will 
automatically add any support routines. 


error  -savesthe emorfile asa text 
file to the same directory asthe source 
file. This file hasthe same file name but 
with an ‘.ser’ (source error) file exten- 
sion. It contains all the error messages 
(which includes the source line number) 
but not any of the source or assembler 
code. 


font - to change the font or font 
size of the text displayed on the screen 
press the font button. A font dialogue 
box will appear from which you 
choose the required font and font size. 


pins - wil display the PIC рїп 
names and colour coded input or out- 
put port pins. 


display - if there are any compileremor 
messages these are inserted into the 
assembler output file, optionally the 
compiler will stop and display a mes- 


Figure 2. Another example of the PIC Compiler in action. Here, a traffic lights program is 
being written. Note the procedure names in the top right-hand window. 









PIL ТЕ НЫ Есин 


«| mj м) 2] гг] =) aj 


ай aevi Aimar font ріпа рів rawea abut 


















Traffic Lights 2 
Wditben bey Bose Thomas, 


PFoumpiler cleck = 3000 


PASH Liat pe Decne 


pracnadiurm(maimn) 
var x : byte 


[АН source nas] Errore = 0. Compiler qasarnted 7H lines. 


Гимнны compiling CAPIC Compslengrettic?. pst 16205 


| AHHr clock 


KrWZE CF OFF + FWRIE ON + WOT OFF + XI DSC 


: declare variable 

г initíalisse variable ta 0 

г name pect ЕШ te rad 

! beams port RAF to yellow 

; тапап port EL to green 

г таш 'rwud' port pin output 
cut put yellow! | make ‘yallo port pif output 
г makm 'gremsn' port pin cmutput 
: born aff red = D 


Elektor Electronics EXTRA 


men 
кїт 


3 - 1/2000 


RBO 
RB1 
RAO [СЯ RB2 


RA1 RB3 
rap PIC16C84 р, 


RA3 RB5 
RA4 RB6 
RB7 


OSC1 OSC2 um 


Figure 3. Traffic Lights demo hardware. 


sage dialog box (default is to display 
error message). On the first pass any 
error messages will be displayed irre- 
spective of this setting. 


source - selects whether the source 
lines should be included in the output 
assembler file as comments (default is 
to include source code). Source lines 
that only contain a comment will 
always be included. 


abort - 
process. 


stops the compilation 


Next to the eight buttons is a list of all 
the procedure names used in the pro- 
gram. To find and display a particular 
procedure, select it from the list (the 
name will be briefly highlighted) by 
clicking on the left mouse button. The 
screen text should scroll and display 
the relevant procedure (Figure 2). 

The main procedure of the PIC pro- 
gram is called 'main'. Program execu- 
tion will start at this procedure, it is 
called wheneverthe PIC is reset. The PIC 
application program is generally held 
in a continuous loop after any initialisa- 
tion is done, waiting for events to hap- 
pen. It is extremely rare for a PIC pro- 
gram to be required to run only once. 


Compiler code optimisation 


After the compiler has successfully 
compiled a segment of source pro- 
gram, the code optimiser checks the 
assembler program for redundant 
code. Redundant code usually takes 
the form of unnecessary setting or 


4 - 1/2000 





Elektor Electronics EXTRA 


000012 - 13 


reading the various PIC status flags. 
For example, part of a traffic lights 

output procedure is shown, the com- 

piler will generate the following code: 


(Original source code fragment) 


green = 0 turn green off 
yellow = 0 ; turn yellow off 
red = 1 turn on red 


code not optimised 

green = 0 turn green off 
MOVL WH’ 00’ 

BTFSS STATUS, Z 

BSF  PORTB, GREEN 

BTFSC STATUS, Z 

ВСЕ PORTB, GREEN 

yellow = 0 ; turn yellow off 
MOVL WH’ 00’ 

BTFSS STATUS, Z 

BSF PORTB, YELLOW 


BT FSC STATUS; #4 
BCF PORTB, YELLOW 

red = 1 turn on red 
MOVL WH’ 01’ 

BIPSS STATUS, Z 

BSF PORTB, RED 
BTFSC_ STATUS, Z 

BCF PORTB, RED 


With the code not optimised the com- 
piler has calculated the equation after 
the equals sign and sets the bit accord- 
ing to the equation result zero orone. 
The optimiser looks at the code and 
findsithasa constant value asitalways 
has the same result and deletes the 
intermediate calculation. 


code optimised 
green = 0 turn green off 
ВСЕ PORTB, GREEN 


yellow = 0 ; turn yellow off 
BCF PORTB, YELLOW 
red = 1 turn on red 


BSF PORTB, RED 


PIC interrupts 


When an interupt occurs the program 
counter is loaded with address loca- 
tion 4, this contains code to save the 
program status and calls the interrupt 
handler procedure. After completion of 
the interrupt handler code within pro- 
cedure(interrupt), the PIC executes a 
retfie instruction (retum from interrupt). 
It is not necessary for the source pro- 
gram to re-enable global interupts as 
the retfie instruction will do it automati- 
cally. The routine to handle interrupts 
must be called interrupt. 

The use of interrupts makes a PIC pro- 
gram more efficient as the altemative 
is having to continually poll flagsto see 
if a particular event has taken place. 
There are four sources of interupts that 
the PIC 16C84 interrupt handler soft- 
ware hasto deal with: 


1. extemal interrupt on pin RBO; 

2. intemrupt on change to pins RB4-RB7; 
3. RICC timer overflow; 

4. assigned to EEPROM write complete. 


The EEPROM write interupt is taken care 
of by the writeEEPROM function. 

To enable the interrupts use the 
irg enable = true command. The indi- 
vidual interrupt source must be 
selected before this command is 
invoked. 

To disable all interrupt use the 
irg enable = false command. 

This command acts globally using the 
Global Interrupt Enable (GIE) flag irre- 
spective of the individual interrupt 
being used. 

The interrupt handler procedure 
needs a few bytes for intermediate stor- 
age, the interupt routine has to have its 
own variable storage asit cannot share 
storage with the rest of the program. 
As an intemupt can occuratany time it 
is possible that with 16-bit arithmetic this 
could happen half way through an 
arithmetic procedure. Assigning a 16- 
bit variable to another 16-bit variable 
requires multiple instructions to move 
the value of the lower and then the 
higher byte. If an interrupt occurs half 
way through the process then the vari- 
able may end up with the value of the 
old value (lower byte) and the new 
value of the higher byte. For this reason 
the compiler will not allow 16-bit a rith- 
metic in the interrupt handler proce- 
dure. 


PC TOPIC S 


turn on red 
wait(3000) ; wait for 3 seconds 
If you intend to build the circuit shown 


If only one source of interrupts has red = 1 | 
been enabled then it is not necessary 
to look at the individual interrupt 


in Figure 3 please observe the PIC cur- 
rent limits. The maximum total current 
output on Port B is 100 mA, any pin has 


enable flags. In general it is best to 
make the interrupt handler procedure 
as small and execute asfast as possi- 
ble using simple equations. Note that 


Listing 1. Traffic Lights (1) Source program 


other procedures cannot be called | uos M Е тА 

from within the interrupt handler proce- | Il и О 

dure. #compiler clock = 4000 — ; 4MHz clock 
It is better to make a copy of any #ASM list p=16C84 


variable that the interrupt handler may 
use and use the copy. Referencing a 


sepe eGR Or Р Т ОНЕР ОКЕ E AXT OSC 


variable that the interrupt handler var x : word у create 16 bit variable 
directly uses can have unforeseen var y : byte — ; create 8 bit variable 
results. For example, if x ischanged by КОО ООО 

the interrupt handler then the following alias(RB3, red) >. rename port RB3 to red 


program might not function as 
intended. The value of x may have 
been altered after the first but before 


alias(RB2, yellow) ; 
alias(RBl,green) ; 
output(red) 


rename port RB2 to yellow 
rename port RBI to green 
make 'red' port pin output 


the second comparison command, so output(yellow) ; make ‘yellow’ port pin output 
no statements are executed. out put (green) ‚ make ‘green’ port pin output 
eed ; turn off red = 0 
clr(yell ow) ; turn off yellow = 0 
var x : byte cir(green) ; turn off green = 0 
procedure( main) 
if x >=6 and x <= 10 then tH Ee ; initialise = 0 
бох 24 Clery) О ЧАИ ЗЕЕ 
begin | 
РИИ while true 
4 E | h ООО eS x 
ш | Interrup occurs еге if x = 1500 then 
if x >= 0 and x <=5 then begin 
; X changes to 6 | nc( y) Ue ues 
begin eee ооу еу 
statement end 
end else 
begin 
| = 0) AND «c 9 ft 
If a byte variable needs to be incre- Ж. Pe L | 2: 
mented ordecremented or set to zero BOXES] : turn on red 
within the interrupt handler then use yellow = 0 ; turn off yellow 
inc (x) or dec (x) or clr(x) statements as green = 0 ; turn off green 
these compile to a single assembler end 
instruction. | 
if (y >= 50) AND (y<= 75) then 
begin 
Program examples red = 1 ; turn on red 
yellow = 1 ; turn on yellow 
To help demonstrate the advantages of green = 0 ‚ turn off green 
using the compiler and clarify the lan- end 
guage syntax, the documentation file | 
contains some example programs to | к ES 
help illustrate the various compiler Eo B | 
red = 0 ; turn off red 
commands. As these programs are for yellow = 0; turn off yellow 
didactic purposes, they do not neces- green = 1 ‚ turn on green 
sarily represent the best software solu- end 
tion. Note that some of the comment | 
lines have been deleted and the if (y >= 111) AND (y«- 130) then 
assembler file tidied up for publication. begin 
i red = 0 ; turn off red 
All variable labels that the compiler » | 
yellow = 1 ; turn on yellow 
generates are preceded by an under- green = 0. ; turn off green 
score to differentiate them from vari- end 


ables used in the source program. 
The easiest method of implementing 


if y = 131 then 


a traffic lights sequence would be to begin 

use the wait command aftersetting the а r(x) 

appropriate LED on or off. е. PUn 
end 

green e 0 | turn green off loop 

yellow = 0 ; turn yellow off 
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| RA2 1 | i Lbs КАА] ; while true 
RA3 2 | i i | 17 RAQ _ WHI LEO 
RA4 3 | | PO 0567 |i nc( x) M Ne NNI 
| mcr 4 |i Ө с sie INCE X,F 
; Vss 5 | p p | 14 Vdd BTFSC СОО 
RBO 6 |i [|13 АВ] I NCF XH, F 
; GREEN 7 | o0 ШЕК: , if x = 1500 then 
YELLOW 6 Е: Е SET 
; RED 9 | o i | 10 АВА MOVF X, М 
MOV WF _STACKO 
MOVF XH, W 
Ec EQU Н'02' MOV WF ZSJ ACRI 
STATUS EO In Ws MOVLW H' FF’ 
C EQU vie MOV WF _STACK2 
EON In а MOVLW H’ DC’ 
_ RPO EQU H'05' S U B WF STACKU F 
PORTB EQU H'06'’ BTESS СОО 
_РСТАТНЕОО Н'0А' CLRF _$ТАСК?2 
.|NTCON EQU H'OB' MOVLW Н'05' 
ГАО ENABLE EQU H'07' S UB WF EA 
STACKU EQU" RTOC BTESS ATUS 
ЭОК ЕО MAOD CLRF STACK? 
STACK OU ROE: МОМЕ _STACK2, W 
STACKS EU EIE MOV WF _STACKO 
SSO EQU ДТ MOV WF _STACK1 
STACKS EQU RETI Bale ore eo PAU SZ 
SICK EO im M СОЛО ELSE 
SSO EQU RAIS: ; begin 
_STACK8 EQU H' 14’ ; i nc( y) у= у +l 
STACKS EOU MALS INCE F 
X EOU Т: ; ОЕ) ‚ xX = 0 
XH EQU R 17’ CURIE X 
T OUST Tee CERF XH 
RED EQU H'03' н end 
YELLOW EQU H 02 ; else 
GREEN EQU H'01' GOTO _END1 
ELSE 
ORG 0 begin 
i if (y >= 0) AND (y<= 49) then 
goto MAIN ER 
MOVF Y,W 
S MESES о MOV WF _STACKO 
; Written by Roger Thomas. MOVLW H'00' 
S UB WF -STACKO W 
list p=16C84 CLRW 
eo йб рле. BTFSC STATUS Г 
ADDLW ERE 
‚ var x word ; create 16 bit variable MOV WF _5ТАСК4 
|; var y byte ; create 8 bit variable MOVF Y,W 
SUBLW р 
MAIN CLRW 
alas RBS Ted) ‚ rename port RB3 to red BTFSC STATUS C 
‚ alias(RB2,yellow) ; rename port RB2 to yellow ADDLW np 
i üalias(RBl,green] ; rename port RB1 to green ANDWF ТАСКА, М 
; output(red) ; make 'red' port pin output BTFSC ТЭБ 
s ОО GOTO ЕЕ) 
ВСЕ PORTB, RED б begin 
; output(yellow) ; make 'yellow' port pin out- | red = 1 ; turn on red 
put BSF ORDEI 
ВСЕ PORTB, YELLOW ; yellow = 0 ; turn off yellow 
; Output (green) ; make ‘green’ port pin output BCF PORTB, YELLOW 
BCF PORTB, GREEN green = 0 ; turn off green 
‚ «гей ; turn off red = 0 BCF PORTB, GREEN 
BCE STATUS, RPO ' end 
BCF PORTB, RED 
; clr(yellow) ; turn off yellow = 0 ; if (y >= 50) AND (y<= 75) then 
ВСЕ PORTB, YELLOW ELSE? 
; clr(green) ; turn off green = 0 ES 
BCE PORTE, GREEN MOVF Ү, М 
MOV WF _STACKO 
ECC i initialise = 0 MOVLW nie 
CERF А S UB WF _STACKO, W 
CLRF XH CLRW 
y) ~- onitialise = 0 BTFSC SS MUS MC 
СЕКИ ADDLW ШЕЕ 
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MOV WF _5ТАСК4 MOVLW Н' 6Е' 
MOVF Y,W S UBWF _STACKO, W 
SUBLW H' 4B’ CLRW 
CLRW BTFSC STATUS С 
BTESC Мо 1 ADDLW H' FF’ 
ADDLW ae eae MOV WF _STACK4 
AND WF _STACK4, W MOVF Y, W 
ЕС СОБ Е Z SUBLW Н'82' 
GOTO T ELSES CLRW 
| begin BTFSC STATUS C 
| Гей = 1 Тао оптек ADDLW Н'ЕЕ' 
BSF РОАТВ, RED ANDWF _STACK4, W 
yellow = 1 ; turn on yellow BTFSC СТАТ Z 
ВОРОНОВА GOTO Е Е 
green = 0 ; turn off green | begin 
ВСЕ PORTB, GREEN red = 0 ; turn off red 
| end ВСЕ РОАТВ, RED 
| yellow = 1 ; turn on yellow 
“Гү >= ЛО AND ти BSF РОАТВ, YELLOW 
TESES green = 0 ‚ turn off green 
A FA ВСЕ РОАТВ, GREEN 
MOVF Y,W | end 
MOV WF _STACKO 
MOVLW Н'4С' ; if y = 131 then 
S UB WF _STACKO, W ELSES 
CLRW ШЕ; 
КЫП ESTATUS tt MOVF Y,W 
ADDLW ride re SUBLW H 53 
MOVWF _5ТАСК4 MOVLW H’ Os 
MOVF Y, М BTFSC STATUS у 
SUBLW НОЕ ADDLW H' FF’ 
CLRW ANDLW H' FF’ 
SHE SSIs, 6 BTFSC STATUS 7 
ADDLW aie ea COU SEL sete 
AND WF _STACK4, W | begin 
BTESC STATUS, Z C 
GOTO  ELSE4 CIRE X 
; begin CLRF XH 
| red = 0 WE ог тед em 
ВСЕ PORTB RED CORE E 
| yellow = 0 ; turn off yellow ; end 
BCF PORTB, YELLOW | end 
green = 1 ‚ turn on green SESE 
Bok PORTB, GREEN _END1 
| end ; loop 
GOTO _ WHI LEO 
; if (y >= 111) AND (y<= 130) then 
СЕЕ END 
ARS 
MOVF Y,W 
MOV WF _STACKO 


Listing 2. Traffic Lights (1) Assembler program 


a absolute maximum current output of 
20 mA. Incorporate an appropnate 
Current limiting resistor (R) in senes with 
the LED (in the range 470 Q to 1 kQ 
depending on the LED). Here, 680 Q Is 
sug gested. 

The example program will continue to 
execute until the supply voltage is 
removed from the PIC. 

The source code of the program Is 
shown in Listing 1. The ‘x’ vanable is 
incremented on each loop of the pro- 
gram. After reaching a certain number 
it then increments the ‘y’ vanable. This 
isneeded to slow the program down — 
if the ‘x’ variable was used directly the 
lights would switch too fast. The brack- 
ets separating the ‘y’ conditions are not 


PC TOPIC 5 — — — 


required by the compilerbut help doc- 
ument the program. The resulting 
assembly-code file is shown in Listing 2. 
Other programming examples found in 
the documentation file are Traffic Lights 
(2) and LCD Display Driver. The source 
code and assembly-code listings of 
these programs may be found in the 
documentation file. 


Syntax and 
command descnptions 


A full description of all available com- 
mands and the syntax the Compiler 
wants to see may be found in the 56- 
page project documentation file. This 
file, an MS Word document, may be 
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found on diskette no. 996033-1 which 
may be ordered through our Readers 
Services. The disk also contains the 
example source code files (.psf) and, of 
course, the Compiler itself (Com- 
piler84.EXE). The readme.txt file explains 
the extremely simple installation. 


(000012-1) 
Article editing:Jan Buiting 
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